table of contents
| BYZANZ-RECORD(1) | General Commands Manual | BYZANZ-RECORD(1) |
NAME¶
byzanz-record - record your desktop session to an animated GIF
SYNOPSIS¶
byzanz-record [options] FILENAME
DESCRIPTION¶
Byzanz records your desktop session to an animated GIF. You can record your entire screen, a single window, or an arbitrary region. byzanz-record allows you to make recordings from the command line. Graphical users may want to use the panel applet instead.
OPTIONS¶
Application Options:¶
- -d, --duration=SECS
- Duration of animation (default: 10 seconds)
- --delay=SECS
- Delay before start (default: 1 second)
- -c, --cursor
- Record mouse cursor
- -a, --audio
- Record audio from the default input device. This only works if the output format supports it and will otherwise cause an error.
- -x, --x=PIXEL
- X coordinate of rectangle to record
- -y, --y=PIXEL
- Y coordinate of rectangle to record
- -w, --width=PIXEL
- Width of recording rectangle
- -h, --height=PIXEL
- Height of recording rectangle
- -v, --verbose
- Be verbose
- --display=DISPLAY
- X display to use
Help Options:¶
- -?, --help
- Show help options
- --help-gtk
- Show GTK+ Options
- --help-all
- Show all help options
OUTPUT FILE¶
After byzanz-record is finished, the recording is written to FILENAME. The format is determined by the filename extension. The following formats are supported:
- gif
- Record to an animated GIF image. Use this if you want to record a mostly static screen with a limited amount of colors, such as using a file manager or an office application. This is the default and will be used if an unrecognized extension is used.
- ogg, ogv
- Record to an Ogg Theora video. This format supports audio. Use this if you want to record dynamic contents, such as video playback.
- flv
- Record to a Flash Screen video. This recording method is lossless. Use it if you want to postprocess the file in other applications.
- byzanz
- Record to Byzanz' internal debugging format. This is useful for benchmarking Byzanz or if you want to convert the recording to multiple formats later. You can use byzanz-playback(1) to convert the file.
SEE ALSO¶
AUTHOR¶
Byzanz was written by Benjamin Otte <otte@gnome.org>.
This manual page was last updated for version 0.2.1.